home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / logbatch / lanbat.exe / USERMAN.DOC < prev   
Text File  |  1993-08-01  |  47KB  |  1,254 lines
  1. LAN Batch Server 1.2
  2.                                --
  3.                         LAN Batch Server(tm)
  4.  
  5.               THE Local Area Network Task Scheduler
  6.  
  7.  
  8. The  LAN  Batch Server(tm) manual and program were written by
  9. Paul Combellick.
  10.  
  11. COPYRIGHT(c) Paul Combellick, All Rights Reserved, 1993.
  12.  
  13. The  LAN  Batch  Server(tm) documentation and software  contain
  14. copyrighted  works and may only be reproduced or  duplicated
  15. under the terms of the user license agreement.
  16.  
  17. TRADEMARKS:
  18.  Dbase III+ is a trademark of Ashton-Tate, Inc.
  19.  Lotus 1-2-3 is a trademark of Lotus Development Corp.
  20.  MS-DOS is a trademark of Microsoft Corporation.
  21.  IBM AT is a trademark of IBM Corporation.
  22.  Clipper is a trademark of Nantucket Corporation.
  23.  Novell Netware is a trademark of Novell, Inc.
  24.  3+Share is a trademark of 3COM Inc.
  25. Dr. Switch is a trademark of Black and White International.
  26. Pkzip, Pkunzip are trademarks of PKWare, Inc.
  27. CompuServe is a trademark of CompuServe, Inc.
  28.  
  29. LAN  Batch  Server(tm)  is  the type of productivity  enhancing
  30. software  that  you  have come to expect from  the  Computer
  31. Catalyst.    This  powerful  utility  program   keeps   your
  32. computers  working even when you're not.  LAN Batch  Server(tm)
  33. will  schedule time consuming computer tasks to  run  during
  34. non-prime time business hours.  All this power, plus  it  is
  35. easy to setup and can be accessible by every Macintosh or PC
  36. user on your network.
  37.  
  38.                         TABLE OF CONTENTS
  39.  
  40. SYSTEM REQUIREMENTS      
  41. PACKING LIST                  
  42. BENEFITS FOR REGISTERING      
  43. TECHNICAL SUPPORT             
  44. PREPARATION BEFORE CALLING    
  45. INSTALLATION                  
  46. QUICK START                   
  47. WHAT IS LAN BATCH Server(tm)? 
  48. HOW DOES IT WORK?             
  49. FEATURES                      
  50. SETTING UP TASKS IN THE QUEUE 
  51.      USING BSC.exe -          
  52.      USING .JOB FILES         
  53. CHECKING THE STATUS OF TASKS  
  54. EXECUTING TASKS IN THE QUEUE
  55.      USING BS.EXE             
  56. SEMAPHORE FILES               
  57. BONUS FEATURES
  58.       BATCH.EXE,CLIPPER API   
  59.      PARTIAL LISTING OF
  60.      CLIPPER API              
  61. SAMPLE TASKS
  62.      USING BSC.EXE            
  63.      USING CLIPPER API        
  64.      USING .JOB FILES         
  65.      USING BATCH.EXE          
  66. TROUBLE SHOOTING GUIDE        
  67. GLOSSARY                      
  68. LICENSE AGREEMENT             
  69. WARRANTY                      
  70.  
  71. SYSTEM REQUIREMENTS
  72.  
  73. IBM PC or Compatible, including Laptops.
  74.  
  75. MS-DOS 3.3 or greater.
  76.  
  77. 5.25 inch floppy drive.
  78.  
  79. Hard   Disk  Required.  Approximately  1.0  MB  disk   space
  80. required.
  81.  
  82. LAN Optional.  (Network which can run Clipper applications.)
  83. Such as Novell Netware or MS-NetBios Networks.
  84.  
  85. NOTE:   This release is NOT network specific.
  86. PACKING LIST
  87.  
  88. Your  LAN  Batch  Server(tm)  software  package  includes   the
  89. following:
  90.  
  91. Disk #1:
  92.  *   Users Manual   (UserMan.doc)
  93.  
  94.  *   LAN Batch Server(tm) User Interface
  95.                 ( BSC.exe)
  96.  
  97.  *   LAN Batch Server(tm) Engine  ( BS.exe).
  98.  
  99. *    Bsque.dbf ( queue database file ).
  100.  
  101. *    Help files ( Bshelp.dbf , bshelp.dbt ).
  102.  
  103. *    Queue Report  ( Bs.frm ).
  104.  
  105. Bonus  Disk  for registered users only, (not  for  shareware
  106. distribution):
  107.  
  108. *    LAN Batch Server(tm) command line
  109.      queue interface (BATCH.exe).
  110.  
  111. *    Clipper API source  & example  files
  112.      (bs_api.prg)
  113.  
  114. *    CodeBase API source & example files
  115.  
  116. BENEFITS OF REGISTERING YOUR SOFTWARE
  117.  
  118. Registration  Fee is $95.00 per file server or  shared  disk
  119. that the queue file, bsque.dbf, is loaded on.
  120.  
  121. Free updates and technical support for one year.
  122.  
  123. Receive  source code to access the LAN Batch  Server(tm)  queue
  124. file from a Clipper 5.x and Summer '87 applications.
  125.  
  126. Receive  source code to access the LAN Batch  Server(tm)  queue
  127. file from a C application using CodeBase.
  128.  
  129. Receive BATCH.exe, which provides command line access to the
  130. batch queue.
  131.  
  132. Telephone support:  (602) 946-9341.
  133.  
  134. Electronic  mail support via CompuServe:.  Paul  Combellick:
  135. 70671,3054
  136.  
  137. NOTE:   This release is NOT network specific.
  138.  
  139. HOW TO REGISTER (See REGIST.TXT on this disk.)
  140.  
  141. TECHNICAL SUPPORT
  142.  
  143. Technical support is provided, for registered users only, by
  144. Computer Catalyst Corporation  at the following address:
  145.  
  146.      Computer Catalyst Corporation.
  147.      P. O. Box 14576
  148.      Scottsdale, AZ  85267-4576
  149.  
  150.      (602) 946-9341 Voice and FAX
  151.  
  152.      Compuserve ID#: 70671,3054,  Paul Combellick
  153.  
  154.  
  155. Computer  Catalyst  encourages both  positive  and  negative
  156. feedback  from LAN Batch Server(tm) users.  If you  are  having
  157. technical  problems with LAN Batch Server(tm), have  ideas  for
  158. enhancements, or have a unique or interesting way  of  using
  159. LAN  Batch Server(tm), please send us a letter, fax, email,  or
  160. give us a call!
  161.  
  162.                  SOFTWARE MAINTENANCE AGREEMENT
  163.  
  164. Includes  1  year  software upgrades.   Annual  support  fee
  165. covers   technical   support  and  software   upgrades   and
  166. enhancements for one year.
  167.  
  168. PREPARATION BEFORE CALLING FOR SUPPORT
  169.  
  170. Having   complete  and  pertinent  information   about   the
  171. questions  or problems you are having can reduce delays  and
  172. expedite answers. Please provide the following information:
  173.  
  174.      1         Registered Users Name and
  175.                Address
  176.      2         LAN Batch Server(tm) Serial
  177.                Number and Version number
  178.      3         DOS brand and version
  179.      4         Copy of CONFIG.SYS
  180.      5         Copy of autoexec.bat
  181.      6         Amount of RAM available
  182.                before loading
  183.      7         Amount of disk space available
  184.      8         Copies of BS.LOG and BS.ERR
  185.      9         Description of problem in
  186.                complete detail.
  187.      10        Other symptoms
  188.  
  189.  
  190. INSTALLATION
  191.  
  192. LAN  Batch Server(tm) should be installed on a hard drive.  The
  193. queue  file,  BSQUE.DBF  should be  installed  on  a  shared
  194. network.  The exe files may be stored locally or on the file
  195. server.
  196.  
  197. The installation of LAN Batch Server(tm) on your hard disk will
  198. be  handled by the INSTALL.BAT batch file included  on  your
  199. program disk.  About 1.0 megabytes of space are required  on
  200. the target disk.
  201.  
  202. After  installation, you should define two  DOS  environment
  203. variables BS and BS_DATE.  BS should contain the path to the
  204. directory  that  contains the queue  file,  BSQUE.DBF.   The
  205. default  is  the  current directory. BS_DATE should  contain
  206. your preferred date format.  The default is AMERICAN.  Other
  207. date  format options are ANSI, BRITISH, FRENCH,  GERMAN,  or
  208. ITALIAN.
  209.  
  210. For   example,   add  the  following  two  lines   to   your
  211. autoexec.bat:
  212.  
  213.      SET BS=Z:\BS
  214.      SET BS_DATE=ANSI
  215.  
  216. This  sets the queue directory to Z:\BS and the date  format
  217. to ANSI.
  218.  
  219. This installation procedure will:  MAKE a directory on drive
  220. C: named C:\BS COPY all the necessary files from the program
  221. disk INSTALL LAN Batch Server(tm) with the following steps
  222.  
  223. Change to drive A:
  224. Type A: <ENTER>
  225. Place program disk in drive A, Type INSTALL <ENTER>
  226.  
  227. The install program will copy all necessary files to run LAN
  228. Batch Server(tm) to C:\BS. The INSTALL program will verify that
  229. all  files are successfully copied, if an error is detected,
  230. you will be prompted to try again.
  231.  
  232. To  have  the install program copy the files to a  different
  233. destination,  type  in that destination  after  the  INSTALL
  234. command and before pressing <ENTER>.
  235.  
  236. EXAMPLE:       INSTALL D:\BS <ENTER>
  237.  
  238.   This will create a directory on drive D: called \BS and copy
  239.                        the files into it.
  240.  
  241. QUICK START
  242. Use  your  networked computers 24 hours a  day.   LAN  Batch
  243. Server(tm) is designed to schedule jobs to run during free time
  244. on  a  MS-DOS  system.   First, set up  the  tasks  to  run.
  245. Schedulable tasks are batch files, executable programs,  any
  246. task that can be run from the DOS prompt. These tasks can be
  247. scheduled  to execute on any schedule; once, hourly,  daily,
  248. monthly,  yearly,  or  beginning  on  a  certain  day  at  a
  249. specified time with a specified ending date and time.  These
  250. tasks  can  be added to the queue even while the engine,  or
  251. back end is running.
  252. Next,   start the engine of LAN Batch Server(tm) on a local  or
  253. remote  PC on the LAN.  The LAN Batch Server(tm) engine   steps
  254. through  the queue of tasks, prioritizes, and spawns  tasks,
  255. until it is turned off.
  256.  
  257. To RUN LAN Batch Server(tm):
  258. Change drive to D:
  259.      type D: <ENTER>
  260. Change to BS directory type
  261.      CD\BS <ENTER>
  262. To  add  items  to  the  queue  type                     BSC
  263. <ENTER>
  264. Select  ADD, edit the fields, select <F10> to save and  exit
  265. the edit mode.
  266.  
  267. To start the engine program type
  268.      BS <ENTER>
  269.  
  270. What is LAN Batch Server(tm)?
  271.  
  272. Computer  Catalyst  Corporation is  proud  to  announce  the
  273. release  of  LAN Batch Server(tm). The Local Area Network  Task
  274. Scheduler.  LAN Batch Server(tm) allows you to maximize the use
  275. of your expensive computer resources. With LAN Batch Server(tm)
  276. you no longer have to be around to tell you computer what to
  277. do, just tell LAN Batch Server(tm) what you want done, when you
  278. want  it  done and LAN Batch Server(tm) will do the rest  -  it
  279. works 24 hours a day, so you can enjoy your time off.
  280.  
  281. Most  computer  resources  are utilized  during  the  normal
  282. business  hours of the day, typically 8-5. this  is  only  8
  283. hours  out  of a 24 hour day, this means that for two-thirds
  284. of the time these valuable tools sit idle.
  285.  
  286. LAN Batch Server(tm) helps you maximize your computer resources
  287. by  allowing  you to schedule time intensive  tasks  to  run
  288. during  non-critical hours, instead of prime time when  most
  289. computer resources are often being used to their capacity.
  290.  
  291. LAN  Batch Server(tm) is an application program that will allow
  292. users connected to a local area network to schedule tasks to
  293. execute  at  any time of the day or night. Any  application,
  294. Macintosh, or PC that can write an ASCII file to  a  network
  295. queue directory, can add tasks to the queue.
  296.  
  297. With  LAN  Batch  Server(tm)  you can schedule  reports  to  be
  298. processed  and  printed at night so they are  ready  at  the
  299.  
  300. beginning of the next work day.
  301.  
  302. Programmers can schedule time consuming compiles  and  links
  303. to run after they have gone home for the day.
  304.  
  305. Critical functions like complete BACKUPS can be scheduled to
  306. run at anytime of the day or night.
  307.  
  308. Database maintenance such as REINDEXING & PACKING can easily
  309. be performed during non business hours.
  310.  
  311. How does LAN Batch Server(tm) work?
  312.  
  313. LAN  Batch  Server(tm) is a client/server application  program.
  314. The  clients  schedule  tasks for the  servers  to  execute.
  315. These tasks or jobs may be scheduled to run only once or  at
  316. set  intervals  such as hourly, daily, weekly,  or  monthly.
  317. LAN Batch Server(tm) gives the user complete flexibility on the
  318. frequency  to  schedule  jobs for  execution.  One  or  more
  319. computers  can be designated as batch servers.  The  servers
  320. execute  the  jobs sent by the clients on the network.   Any
  321. users on the network can be a client and schedule tasks  for
  322. the server to execute.  The server puts each task in its  TO
  323. DO  list  called a QUEUE. There are four different  ways  to
  324. access  the queue:
  325.      BSC.exe:  The front end queue editor or
  326.      client  allows the user to add, edit, delete, and
  327.      monitor tasks in the queue file named BSQUE.DBF.
  328.  
  329.      BATCH.exe: This command line program allows users
  330.      to  add  tasks  to the  queue  directly from the DOS
  331.      command line or from a DOS batch file.
  332.  
  333.      .job  files: User created ASCII files containing
  334.      queue entries.
  335.  
  336.      API: Provides Clipper or C programmers a method to
  337.      access the queue directly from their own software.
  338.  
  339.   The  back  end  batch executive or server engine,  BS.EXE,
  340. monitors  the  queue file for tasks that are  scheduled  for
  341. execution. When the tasks' schedule time arrives the  server
  342. spawns the task and allows it to run to completion.
  343.  
  344. FEATURES
  345.  
  346. Create a report server or compile server.
  347.  
  348. Schedule network monitor utilities to run periodically.
  349.  
  350. Semaphore files allow the LAN manager to control access  to
  351. the queue.
  352.  
  353. MAC users on the network can add tasks to the queue with  an
  354. ASCII file.
  355.  
  356. Any  number of PCs can submit jobs.  Any number of  PCs  can
  357. execute jobs.
  358.  
  359. Jobs can be submitted to the queue while the engine is running.
  360.  
  361. Don't  tie up your valuable PC time with that big accounting
  362. or database report.
  363.  
  364. For registered users only, API source code for Clipper and
  365. Codebase programs to access the queue.
  366.  
  367. Split a job into pieces and send it to multiple machines.
  368.  
  369. Indexing,  reporting, packing, calculating, backing  up  the
  370. system,  can be run while no one is around. No idle  waiting
  371. time, just the computer(s) running non-interactive tasks.
  372.  
  373. Eliminate  personnel downtime while waiting for a report  to
  374. be generated.  LAN Batch Server(tm) can assign a report to a PC
  375. which  is currently unoccupied or unused.  Perhaps a  worker
  376. is  out  sick and their computer is idle or you have an  old
  377. machine  that no one uses because it is too slow, now  these
  378. PCs  can be put to work, while your machine is free for  you
  379. to continue your work.
  380.  
  381. Schedule batch files to run after midnight that compile  and
  382. link,  reindex, pack or back up your system.   Create  batch
  383. files  for  jobs  that  don't  need  interactive  input  and
  384. schedule them in the LAN Batch Server(tm).
  385.  
  386. Use a keyboard buffer stuffer for interactive tasks.
  387.  
  388. CAVEAT:   IT  IS  POSSIBLE TO USE THIS  TOOL  TO  CIRCUMVENT
  389. NETWORK SECURITY. HAVE THE LAN BATCH Server(tm) ENGINE (BS.EXE)
  390. RUN  ON  A  WORKSTATION WHOSE NETWORK LOGIN  HAS  NO  HIGHER
  391. ACCESS RIGHTS THAN THE USER THAT SCHEDULED THE JOB.
  392.  
  393. SETTING UP TASKS IN THE LAN BATCH Server(tm) QUEUE
  394.  
  395. USER ID:
  396.  
  397. Before you use LAN Batch Server(tm) you may first specify  your
  398. name  or  Network User ID.  This will be useful in  checking
  399. the status of in-progress jobs. LAN Batch Server(tm) has a
  400. report option which will print out a progress report on the
  401. jobs  in  the queue.  This report can be sorted on USERID.
  402. The USERID may be specified in a DOS environment variable.
  403.  
  404. SET USER=<your name here>
  405.  
  406. There are four methods to add tasks to the queue:
  407.                (1) BSC.exe,            
  408.                (2) BATCH.exe  
  409.                (3) .JOB files        
  410.                (4) the API           
  411.  
  412. Using BSC.exe
  413.  
  414. BSC.exe  is  the  client program to add,  edit,  delete  and
  415. monitor  tasks  in the queue file. Type BSC <ENTER>  at  the
  416. C:\BS  prompt  or  at  the LAN Batch Server(tm)  directory  you
  417. specified.   All fields are optional except for the  command
  418. line.   To  add to the queue, select ADD, edit  the  fields,
  419. select <F10> to save and exit the edit mode.
  420.  
  421. THE SCREEN
  422.  
  423. The  queue  editor  input screen is separated  into  several
  424. areas.   Along the bottom are the menu selections which  are
  425. your  choices in manipulating the queue.  At the top of  the
  426. screen  is the heading with some information such as version
  427. number  and  in  the  upper right hand corner,  the  current
  428. record  number.   The two areas in the center  are  Schedule
  429. Information,   which   is   user  modifiable,   and   Status
  430. Information,   which   is   program   modifiable.   Schedule
  431. Information  is  where the items are added into  the  queue.
  432. Status  Information is where the engine writes the  progress
  433. being made in the queue.
  434.  
  435. On line help is available by pressing F1.
  436.  
  437. MENU SELECTIONS
  438.  
  439. These menu choices appear at the bottom of the screen.
  440.  
  441. ADD            Add a new entry into the Queue.
  442. BROWSE         View the Queue in table form.
  443. CLONE          Copy the displayed entry to
  444.                another record.
  445. DEL            Remove a job from the Queue
  446.                 and delete the record.
  447. EDIT           Modify the displayed Queue
  448.                 entry.
  449. FIND           Find an entry in the Queue based
  450.                 on the current Sort.
  451. INDEX          Remove blank queue entries and
  452.                 rebuild the index files.
  453. LOG             View the Queue status log file.  Contains  a
  454. history   of   tasks  that  have  been  executed.    Records
  455. start/stop  of server engine.  Reports which server  runs  a
  456. task, begin / end time, and execution status.   (BS.LOG will
  457. become full and you may wish to delete it when it becomes to
  458. lengthy.)
  459.  
  460. NEXT Advance to the next entry
  461.                 depending on current Sort.
  462. PREV Move to the previous entry
  463.                 depending on current Sort.
  464. QUIT           Return to DOS.
  465. REPORT         Generates a report based on
  466.                current sort criteria.
  467. SORT Select the display Sort criteria
  468.                (there are a total of 4):
  469.                *Primary sort: schedule date +
  470.                           time.
  471.                *by command line entry.
  472.                *by userid + schedule date
  473.                 + time.
  474.                *by record number.
  475.                Sort does not change the actual
  476.                order of jobs in the queue, only
  477.                the display order.
  478.  
  479. COMMAND LINE:
  480.  
  481. This  is the only mandatory field.  It CANNOT be left blank.
  482. If all other fields are left blank, this item will be run as
  483. soon as possible when the server engine is running.
  484.  
  485. This  is the command that you want the LAN Batch Server(tm)  to
  486. have DOS execute. This string can be 125 characters long (it
  487. will scroll off the screen), and should contain the name  of
  488. an  executable  file  or a batch file.   It  cannot  contain
  489. interactive commands.
  490.  
  491. EXAMPLE:
  492.  
  493. 1)   DIR > DIR.TXT
  494.      This would write the current directory
  495.      listing into a file called DIR.TXT.
  496.  
  497. 2)   DBASE SAMPLE
  498.      This would run the dBASE program
  499.      sample.prg provided that dBASE.exe
  500.      is in the path.
  501.  
  502. 3)   SAMPLE
  503.      This would run this SAMPLE.COM,
  504.      SAMPLE.EXE, OR SAMPLE.BAT if it
  505.      is on this directory or in the path.
  506.  
  507. 4)   CMAIL /A REPORT.TXT /T NAME
  508.      This would send a 3COM electronic
  509.       mail to NAME.
  510. You can create batch files for situations that don't require
  511. interactive commands..  When writing batch files be sure  to
  512. restore  the current drive and current directory to the  LAN
  513. Batch Server(tm) directory at the end of the batch file.
  514.  
  515. Example  batch  files that can be executed  from  LAN  Batch
  516. Server(tm).
  517.  
  518. CUSTLIST.BAT
  519. F:
  520. cd\cust
  521. dbase custlist
  522. C:
  523. cd\bs
  524.  
  525.      *CUSTLIST.PRG
  526.      use custlist
  527.      INDEX ON name TO NAME
  528.      quit
  529. See Setting Up Sample Tasks.
  530.  
  531. BEGIN DATE
  532.  
  533. This  field is optional and its default is blank.   If  left
  534. blank  the job will execute as soon as possible.  The  range
  535. is today until the end date or forever.
  536.  
  537. This  date field determines when the entry will be executed.
  538. The  LAN Batch Server(tm) will execute this entry when the DATE
  539. +  TIME  is  passed.  The execution time is not  guaranteed;
  540. however,  entries are processed in DATE + (TIME *  PRIORITY)
  541. order.   If a task's scheduled begin time is passed, it will
  542. be  executed  as soon as a server is available.   Tasks  are
  543. ALWAYS executed in DATE + (TIME * PRIORITY)  order.
  544.  
  545. Several DATE types are supported:
  546.  
  547.      AMERICAN mm/dd/yy (DEFAULT
  548.       FORMAT)
  549.      ANSI      yy.mm.dd
  550.      BRITISH   dd/mm/yy
  551.      FRENCH    dd/mm/yy
  552.      GERMAN    dd.mm.yy
  553.      ITALIAN   dd-mm-yy
  554.  
  555. In  order to specify a non-AMERICAN  date format, define DOS
  556. environment  variable "BS_DATE" to the format  of  the  date
  557. desired.   Now,   re-index the index files  in  the  program
  558. directory  by selecting I for index in BSC.exe.
  559.  
  560. EXAMPLE: To define ANSI date format, type:
  561.  
  562.      SET BS_DATE=ANSI
  563.  
  564. At  the  DOS  prompt.  The date display format will  now  be
  565. ANSI.
  566.  
  567. BEGIN TIME
  568.  
  569. This  field is optional and the default is blank.   If  left
  570. blank, it will be run as soon as possible.
  571.  
  572. Specify  the  scheduled TIME to execute the job.   Remember,
  573. jobs  are  processed as soon as possible  ON  or  AFTER  the
  574. scheduled execution time.  No job is interrupted to  execute
  575. another.   Each job is allowed to complete before  the  next
  576. task is spawned.
  577.  
  578. The LAN Batch Server(tm) clock is a 24 hour clock, therefore if
  579. you want something to begin at 6:00 p.m., input the time  as
  580. 18:00 hours.
  581.  
  582. The   time  format  is:   hh:mm:ss   (hours,  minutes,   and
  583. seconds).
  584.  
  585. The  time may be left blank.  If the date and time are  both
  586. left blank, a job will be executed as soon as possible.
  587.  
  588. SERVER NAME:
  589.  
  590. DEFAULT is blank.
  591.  
  592. Enter the server's "name" or network interface card address.
  593. This   can   be  used  to  dispatch  a  job  to  a  SPECIFIC
  594. PC-workstation.  Ethernet Network Interface Cards (NIC) have
  595. unique 16 character serial numbers.
  596.  
  597. ***Note, the workstation's NIC address is displayed on  line
  598. 2 under the program title.
  599.  
  600. A  "name" can also be specified, here.  Then, when BS.exe is
  601. executed,   a   parameter  will  specify   that   particular
  602. workstation's "name".  Refer to use of BS.exe  under  "Using
  603. the back end to perform tasks in the queue". 
  604.  
  605. How would one schedule workstation 12 to run report 4?
  606.  
  607.      In the SERVER field, enter 12.
  608.  
  609.      On the workstation that you want to
  610.      name as server 12, start the Batch
  611.      Server engine with the following
  612.      command:
  613.  
  614.      BS /NAME=12
  615.  
  616. PRIORITY:
  617.  
  618.      DEFAULT is 5.
  619.      RANGE is 0, lowest priority, through 9,
  620.       highest priority.
  621.      OPTIONAL.
  622.  
  623. The  priority  enables  users to prioritize  jobs  that  are
  624. scheduled  for the same date and time.  Remember,  scheduled
  625. execution time is not guaranteed, jobs run based on DATE + (
  626. TIME * PRIORITY ).
  627.  
  628. FREQUENCY:
  629.  
  630.      OPTIONAL.
  631.      DEFAULT is 1 time execution.
  632.      RANGE: 1 time, minutes, hourly, daily,
  633.       weekly,  monthly.
  634.  
  635. Note:           The frequency cannot be more often then  the
  636. delay  time  the queue is searched for pending tasks.   This
  637. delay  time is specified when the server engine is  started.
  638. (See  "Using  the back end to perform tasks in  the  queue".
  639. If  the  batch server's delay time, default  to  one
  640. minute, is set at 15 minutes, then scheduling a task to  run
  641. every five minutes will not work as expected.
  642.  
  643. Mxx  Where  xx  represents the number  of  MINUTES  to  wait
  644.      before the next execution of this job.
  645.  
  646.      M10 means schedule this job to run again in 10 minutes.
  647.  
  648. Hxx  Where  xx represents the number of HOURS to wait before
  649.      the next execution of this job.
  650.  
  651. Dxx  Where  xx represents the number of DAYS to wait  before
  652.      the next execution of this job.
  653. D    Means schedule it again to run the next day.
  654.  
  655. Wxx  Where  xx represents the number of WEEKS to wait before
  656.      the next execution of this job.
  657.  
  658. MOx  where  x represents the number of MONTHS to wait before
  659.      the next execution. of this job.
  660.  
  661. Note: the "xx" number is optional.
  662.  
  663.  
  664. OS:  (Operating System.)
  665.  
  666.      OPTIONAL.
  667.      DEFAULT is DOS.
  668.      RANGE:  only DOS.
  669.  
  670. Currently only DOS is supported in this release.  Interested
  671. in  other operating systems, such as MS-Windows, Window  NT,
  672. or  OS/2?  Let us know.
  673.  
  674.  
  675. END DATE:
  676.  
  677.      OPTIONAL.
  678.      DEFAULT is BLANK.
  679.      RANGE any future date.
  680.  
  681. For jobs that are scheduled repetitively, an ending date may
  682. be useful.
  683.  
  684. END TIME:
  685.  
  686.      OPTIONAL.
  687.      DEFAULT is BLANK.
  688.  
  689. For  jobs  scheduled  repetitively, an ending  time  may  be
  690. useful.   The  LAN Batch Server(tm) clock is a 24  hour  clock,
  691. therefore  if you want something to end at 6:00 p.m.,  input
  692. the time as 18:00 hours.
  693.  
  694. USING .JOB FILES TO ADD TASKS TO THE QUEUE
  695.  
  696. Using .JOB files to add tasks to the queue, is a method that
  697. can  be used by any program that can write ASCII files.   If
  698. the  user creates an ASCII file with the .job extension  and
  699. copies it to the queue directory, which is pointed to by the
  700. DOS  environment  variable BS, the LAN Batch  Server(tm)  Batch
  701. Executive, BS.exe, will read the .job files into  the  queue
  702. file.   This technique provides another method to add  tasks
  703. to  the  queue.  The ASCII .job file format is one task  per
  704. record,  or  line, and only the command line  is  necessary.
  705. For  example,  create an ASCII file with the .job  extension
  706. and the following entries:
  707.  
  708. REPORT1
  709. REPORT2
  710.  
  711. A  .job  ASCII file may be created by any software that  can
  712. write  to an ASCII file.  This means that any computer  that
  713. can  access the queue directory on the file server, can  add
  714. tasks to the queue.  This includes non-DOS computers such as
  715. an Apple Macintosh.
  716.  
  717. STATUS INFORMATION
  718.  
  719. This information appears on the bottom half of the screen in
  720. BSC.exe  and is written by the engine portion of  LAN  Batch
  721. Server(tm).  It allows the user to check the status of tasks in
  722. the queue.
  723.  
  724. STATUS:
  725. This  tells  that this item is being processed.   Status  is
  726. blank if task is pending, I if task is in progress, that  is
  727. currently  executing, and E if there  was  an  error  during
  728. execution of the task.
  729.  
  730. ERRORLEVEL:
  731. Displays   a   number  representing  the  results   of   the
  732. application or DOS command.
  733.  
  734.      Exx:      Where xx is the number of the error returned.
  735. The meaning of the number depends on the program or software
  736. running   when  the  error  message  was  given.   Different
  737. software   packages  have  different  numbers   representing
  738. different  errors.  Check your software specific  manual  to
  739. determine the problem.
  740.  
  741. Once  the problem is corrected, the item must be resubmitted
  742. to  the queue.  You can copy the item by cloning it and then
  743. delete the original.
  744.  
  745. USER NETWORK ADDRESS:
  746. Contains  the Network Interface Card Address if readable  by
  747. application.
  748.  
  749. SERVER NETWORK ADDRESS:
  750. Will  contain the Network interface card address  or  server
  751. name of the machine that is executing that particular task.
  752.  
  753. USER ID:
  754.   This  will be useful in checking the status of in-progress
  755. jobs. Before you use LAN Batch Server(tm) you may first specify
  756. your  name  or  Network User ID.   LAN Batch Server(tm)  has  a
  757. report option which will print out a progress report on  the
  758. jobs  in  the queue.  This report can be sorted on USER  ID.
  759. The USERID may be specified in a DOS environment variable.
  760.  
  761. SET USER=<your name here>
  762.  
  763. If the DOS environment variable USER is not set you can
  764. enter USERID manually.
  765.  
  766. USING THE SERVER BACK END TO EXECUTE THE TASKS IN THE QUEUE
  767.  
  768. TYPE BS /(ANY OPTIONS DESIRED) <ENTER> at the DOS prompt  in
  769. the directory where BS.EXE is located.
  770.  
  771. For Example:
  772.  
  773.      BS.EXE /begin=22:00 /until=6:00    /delay=15 /name=PC12
  774.  
  775. This means begin processing the queue at 10:00 p.m.  Quit at
  776. 6:00 a.m.  Set the delay between loops through the queue  at
  777. 15 minutes.  The server name is PC12.
  778.  
  779. Type  BS.EXE ? <ENTER> at the DOS prompt to get all possible
  780. arguments.  These options will appear:
  781.  
  782.      /until=<time>   Process UNTIL a planned Time.
  783.                          
  784.      /begin=<time>   Begin Processing at Time.
  785.                          
  786.      /loops=<number> Process each item a given NUMBER of times.
  787.                     
  788.      /delay=<minutes> Set DELAY between Processing  Loops.
  789.                          
  790.      /name=<string>  Set NAME of this server. This is how to 
  791.                      assign jobs to a server by it's NAME.
  792.      
  793. These  commands may be abbreviated by using  the  first  two
  794. characters in the command word.
  795.  
  796. ADMIN FUNCTIONS: SEMAPHORE FILES
  797.  
  798. These semaphores were developed as a result of several years
  799. of  network  administrator experience on  the  part  of  the
  800. author.   Semaphore files, or signals, are  specially  named
  801. files  that BSC.exe, BATCH.exe, and BS.exe look for  in  the
  802. queue  directory, pointed to by the DOS environment variable
  803. BS.   The presence of these files signal certain actions  by
  804. the LAN Batch Server(tm) programs.  The contents of these files
  805. are  meaningless  and may be empty.  The  purpose  of  these
  806. semaphores,  is  to  allow the Network  Manager  to  control
  807. access to the queue by creating a file with a text editor or
  808. batch file.
  809.  
  810. The  SERVER  software,  BS.exe, responds  to  the  following
  811. semaphores:
  812.  
  813. LOGOUT.BS      -    Causes server software (BS.exe) to exit to DOS.
  814.                          
  815. REBOOT.BS      -    Run REBOOT.COM at the DOS prompt.
  816.                          
  817. REINDEX.BS     -    reindex queue file.
  818.  
  819. PAUSE.BS       -    Causes wait until semaphore (PAUSE.BS) is
  820.                     deleted.
  821.  
  822. The CLIENT software, BSC.exe or BATCH.exe,responds to the 
  823. following semaphores:
  824.  
  825. LOGOUT.BSC     -    Causes exit to DOS.
  826. PAUSE.BSC      -    Causes wait until semaphore (PAUSE.BSC) is deleted
  827.  
  828. For example, if the Network Manager wants all users that are
  829. running  BSC.exe,  to  exit  to DOS,  create  a  file  named
  830. LOGOUT.BSC  in  the  queue  directory.   When  BSC.exe  or
  831. BATCH.exe  detect the presence of the file  LOGOUT.BSC,  the
  832. software will exit to DOS.
  833.  
  834. The  PAUSE semaphore, causes the software to close the queue
  835. file,  BSQUE.DBF,  and wait a minute.  After  a  one  minute
  836. wait, it checks for the presence of the PAUSE semaphore  and
  837. if found, repeats the one minute wait.
  838.  
  839. The  server  software,  can be forced  to  REBOOT  with  the
  840. REBOOT.BS semaphore.  This works only if there is a  program
  841. named REBOOT in the path.  This utility is not supplied with
  842. the LAN Batch Server(tm) software and is available as shareware
  843. or a utility elsewhere.
  844.  
  845. The  last semaphore is REINDEX.BS.  This signals the  server
  846. software,  BS.exe,  to delete the queue's  index  files  and
  847. recreate  them.  This will not succeed if other user's  have
  848. the  queue file open.  This is why it is important for  user
  849. written  programs to close the queue file when not  actually
  850. accessing the queue.
  851.  
  852. User written programs should respond to the same signals  as
  853. LAN  Batch  Server(tm) client programs.  This will  maintain  a
  854. consistent response by all users of the queue file and  will
  855. allow the Network Manager to perform maintenance tasks  upon
  856. the queue and the program files.
  857.  
  858. BONUS FEATURES FOR REGISTERED USERS ONLY:
  859. (These are not included on the shareware disk)
  860.  
  861. BATCH.EXE: COMMAND LINE QUEUE ACCESS.
  862.  
  863. In addition to the BSC.exe queue editor, users may add tasks
  864. to  the  queue simply by preceding the desired command  with
  865. the command: BATCH.  For example, to add a task to the queue
  866. named "REPORT1" type:
  867.  
  868. BATCH REPORT1
  869.  
  870. This  will add a record to the queue file with "REPORT1"  as
  871. the command line.
  872.  
  873. CLIPPER API:  The Clipper Application Programmer's Interface
  874. provides  source code that users of Clipper  Summer  '87  or
  875. Clipper  5.x  can use to access the LAN Batch Server(tm)  queue
  876. file, bsque.dbf. See sample tasks.
  877.  
  878. CODEBASE   API:    The  CodeBase  Application   Programmer's
  879. Interface  provides source code that users of  CodeBase  can
  880. use to access the LAN Batch Server(tm) queue file, bsque.dbf.
  881.  
  882. CLIPPER API
  883.  
  884. Partial Listing of BS_API.PRG - the Clipper API to LAN Batch
  885. Server(tm) queue file: (This is available for registered users
  886. only.  See Benefits of registering.)
  887.  
  888. SETTING UP SAMPLE TASKS
  889.  
  890. Using BSC.exe
  891.  
  892. Start  the front end by typing BSC at the LAN Batch  Server(tm)
  893. Directory.
  894.  
  895. Input your USERID which can be your name.
  896.  
  897. Type A to ADD a record.
  898.  
  899. Type DIR > TEST1.TXT at command line.
  900.  
  901. Press F10 to save this record and then Q to QUIT.
  902.  
  903. From your PC or another workstation on the network: Type  BS
  904. at the DOS prompt to run the server engine.
  905.  
  906. The  server  engine or back end then runs  and  deletes  the
  907. queue item.  Press escape to stop the engine from running.
  908.  
  909. Type  BSC at the DOS prompt and see that the queue is empty.
  910. Look at the log.  Type L for LOG and notice that it ran.
  911.  
  912. Type A to ADD a job to the queue.
  913.  
  914. Type  Dir.  >  test2.txt put in 2 minutes from your  current
  915. system time.  Save and quit.  Start the engine by typing BS.
  916. Let  a  couple minutes pass.  Type BSC and see the queue  is
  917. empty and look at the log and when the item was processed.
  918.  
  919. Type A to ADD a job to the queue.
  920.  
  921. Type  Dir  > test3.txt.  Put in 2 minutes from your  current
  922. system time and then put into the frequency field  D   which
  923. means  daily.   Quit and run the Engine.  Allow the  server,
  924. BS.EXE,  to  run through the queue for at least two  minutes
  925. then  go back to view the queue with BSC.EXE.  See that  the
  926. entry  is  still  there and that the  date  field  has  been
  927. updated to tomorrow's date.  It will run each day until this
  928. item is deleted from the queue.
  929.  
  930. USING THE API TO ACCESS THE QUEUE    (For Registered Users)
  931.  
  932. Suppose you have written a Clipper application that has  two
  933. main components.  The first is the user interface or editor,
  934. called EDIT.exe, and the second is the report module, called
  935. REPORT.exe  or  you  might use the R&R Report  Writer.   The
  936. editor could be designed to allow the user to view and  edit
  937. records  in  your database.  Since your database is  several
  938. megabytes in size and contains thousands of records, no user
  939. wants  to  tie  up  their PC while reports  or  queries  are
  940. generated.   The  way around this would be to  add  a  query
  941. builder  module  to the editor to allow the user  to  define
  942. queries  or reports.  After the user has defined  a  report,
  943. the  editor would write an entry into the LAN Batch  Server(tm)
  944. queue   file,   BSQUE.DBF,  using  the  Clipper   API   (see
  945. BS_API.PRG).  One or more other PCs on your network may  run
  946. the   LAN  Batch Server(tm) engine, BS.exe and actually execute
  947. the  report  module of your application.   This  means  that
  948. while the report is running on the server PC, the user's  PC
  949. is  not tied up.  You may also schedule the report to run at
  950. night.    If  you create a batch file that contains  several
  951. commands such as print the report to a file, then email  the
  952. report to a list of people, then notify the sender that  the
  953. report is complete.  The batch file might look like this:
  954.      rem MYREP.BAT
  955.      rem example batch file for reporting
  956.      rem
  957.      REPORT <arg1> <arg2>
  958.      EMAIL <arg3> <arg4>
  959.      SEND "your report sent!" TO <user>
  960.  
  961. Using .JOB files to access the queue
  962.  
  963. If  your  database or programming language does not  support
  964. the  Clipper  API,  such  as C or Basic,  or  another  dBase
  965. compatible,  the  only  change in  this  technique  is  that
  966. instead  of  writing directly to the queue, you would  write
  967. your  queue request into a .job file and write the file into
  968. the same directory that contains the active queue file.  The
  969. server software, BS.exe, will read the .job file and load it
  970. into the queue file.
  971.  
  972. Using BATCH.exe    (For Registered Users)
  973.  
  974. To add a task to the queue named "REPORT1" type:
  975.  
  976. BATCH REPORT1
  977.  
  978. This  will add a record to the queue file with "REPORT1"  as
  979. the command line.
  980.  
  981. TROUBLESHOOTING
  982.  
  983. Symptom: Bad command or file name when trying to run BSC.exe
  984. or BS.exe
  985. Problem: BSC.exe or BS.exe not in path
  986. Resolution: Consult DOS manual to configure path.
  987. Related Problem: Similar path problems can occur when BS is
  988. processing the queue. If your program or batch file changes
  989. the current directory it should restore the current
  990. directory to whatever it was before your program ran.
  991.  
  992. Symptom:  Cannot view BS.LOG file from BSC
  993. Problem:  BS.LOG does not exist or is larger than 64 K.
  994. Resolution: BSC.exe is a Clipper application and cannot view
  995. a  text file larger than 64K. You can rename or delete  your
  996. current  BS.LOG file and BS.exe will create a new file  when
  997. it is run.
  998. Related  Problem:   If  you have limited  hard  disk  space,
  999. BS.LOG should be periodically reviewed and deleted.
  1000.  
  1001. Symptom:  Cannot find record in queue or, applications kicks
  1002. you out when moving between records.
  1003. Problem: Corrupted index file
  1004. Resolution:  Select Index in BSC.exe to recreate the index
  1005. file
  1006.  
  1007. GLOSSARY
  1008.  
  1009. API            Application Programming Interface.
  1010. Method to access the queue file from a user written program.
  1011. Supported languages are Clipper Summer '87 & 5.x and C.
  1012.  
  1013. BACK  END      Server program that actually runs the tasks
  1014. placed in the queue by the client program.  See server & BS.exe.
  1015.  
  1016. BATCH.EXE      Command line utility to add tasks to the queue file.
  1017.  
  1018. BS             DOS environment variable that contains a
  1019. path to the queue file.
  1020.  
  1021. BS_DATE        DOS environment variable that defines the 
  1022. DATE format.  May be AMERICAN, ANSI, BRITISH, FRENCH,
  1023. GERMAN or ITALIAN.
  1024.  
  1025. BS.EXE         Server program that actually runs the tasks 
  1026. placed in the queue by the client program.  See server & back end.
  1027.  
  1028. BSC.EXE        Client program used to add, edit, or delete tasks in
  1029. the queue file.  This program is also used to monitor the status of
  1030. tasks in the queue. 
  1031.  
  1032. CLIENT         Program that users use to edit the queue file.
  1033.                See also BSC.exe, .job, and BATCH.exe.
  1034.  
  1035. DATE TYPE      see bs_date
  1036.  
  1037. ERROR FILE     ASCII  file, bs.err, that the programs write error
  1038. messages into.  This is a good place to look for clues as to why 
  1039. a program failed to work as expected.
  1040.  
  1041. FRONT END      see  client, bsc.exe, and batch.exe
  1042.  
  1043. INDEX  FILE    A file with a .ntx  extension that contains the
  1044. "sort  order"  of  the database  file.  These sometimes get corrupted.
  1045. See the trouble shooting guide.
  1046.  
  1047. .JOB FILE      An ASCII file that the user created and specified a
  1048. task for LAN Batch Server(tm) to run.  This provides a method for 
  1049. many Mac or PC applications to add tasks to the queue.
  1050. Write this file into the queue directory.
  1051.  
  1052. LOG FILE       An ASCII file that contains historical information
  1053. about the execution of tasks in the queue.  It records when servers
  1054. were started or stopped and when tasks were executed.  BS.LOG.
  1055.  
  1056. PATH TO QUEUE  See queue directory.
  1057.  
  1058. QUEUE          A dbase III+ .dbf file named bsque.dbf, that contains 
  1059. the list of tasks and their schedule information.
  1060.  
  1061. QUEUE DIRECTORY Directory that contains the queue file, queue index 
  1062. files, help file (bshelp.dbf & bshelp.dbt & bshelp.ntx).  This directory
  1063. may be the "current" directory or the directory pointed to by the DOS 
  1064. environment variable BS.  See BS.
  1065.  
  1066. QUEUE FILE     See queue.
  1067.  
  1068. SEMAPHORE      An empty file whose existence in the queue directory
  1069. signals the client and server portions of LAN Batch Server(tm) to
  1070. take an action.  The semaphores are LOGOUT, PAUSE, REBOOT, REINDEX.
  1071. See the section on Semaphores.
  1072.  
  1073. SERVER         In the context of LAN Batch Server(tm), the server 
  1074. software is BS.exe and a server is any computer that runs the server 
  1075. software.  Don't confuse this with FILE SERVER!  Although the software
  1076. and queue file may exist on the file server's hard disk, none of
  1077. the programs that are part of LAN Batch Server(tm) are executed
  1078. by the file server.  This is a very subtle but important point.
  1079.  
  1080. LICENSE AGREEMENT
  1081.  
  1082. Copyright (c) 1991 by COMPUTER CATALYST CORPORATION all rights
  1083. reserved.
  1084.  
  1085. Read carefully the following terms and conditions.  Use of
  1086. this product (LAN Batch Server(tm)) constitutes your acceptance
  1087. of these terms and conditions and your agreement to abide by
  1088. them.
  1089.  
  1090. This  is  a  legal agreement between you, the end user,  the
  1091. licensee  and  COMPUTER CATALYST CORPORATION,  licensor.  By
  1092. using  this  package, you are agreeing to be  bound  by  the
  1093. terms of this Agreement. If you do not agree to the terms of
  1094. this  Agreement and you purchased this package directly from
  1095. COMPUTER  CATALYST  CORPORATION, promptly  return  the  disk
  1096. package  and accompanying items (including written materials
  1097. and  binders or other containers within thirty (30) days  to
  1098. COMPUTER  CATALYST  CORPORATION  for  a  refund,  less   the
  1099. shipping  and handling charges. If you obtained the software
  1100. through  a reseller, dealer or distributor consult them  for
  1101. their return policy.
  1102.  
  1103. You,  the  original purchaser, are granted  a  non-exclusive
  1104. license to use this software under the terms stated in  this
  1105. Agreement.  YOU MAY NOT LOAD THE SOFTWARE OR QUEUE  FILE  ON
  1106. MORE THAN ONE NETWORK FILE SERVER OR SHARED DISK AT THE SAME
  1107. TIME.  HOWEVER,  YOU  MAY LOAD THE EXECUTABLE  FILES  ON  AN
  1108. UNLIMITED NUMBER OF LOCAL HARD DRIVES THAT ARE NOT SHARED BY
  1109. OTHER USERS. You may not rent or lease the Software, but you
  1110. may transfer it on a permanent basis if the person receiving
  1111. it  agrees to the terms of the Agreement. If the Software is
  1112. an  update,  any  transfer must include the update  and  all
  1113. prior versions.
  1114.  
  1115. You  may  NOT loan, rent, lease or transfer them to  another
  1116. user  except as part of the permanent transfer (as  provided
  1117. above) of all the Software and accompanying items.
  1118.  
  1119. LICENSEE ACCEPTS PROGRAM "AS IS", "WITH ALL FAULTS", AND  IN
  1120. LIEU  OF  ALL OTHER WARRANTIES AND CONDITIONS, EXPRESSED  OR
  1121. IMPLIED,   INCLUDING,  BUT  NOT  LIMITED   TO,   THOSE   FOR
  1122. MERCHANTABILITY  AND  FITNESS  FOR  A  PARTICULAR   PURPOSE.
  1123. LICENSOR  AND/OR  DISTRIBUTOR ACCEPTS NO RESPONSIBILITY  FOR
  1124. THE OPERATION OR PERFORMANCE OF THE PROGRAM. THE ENTIRE RISK
  1125. OF  USE  AND  CONSEQUENCES  OF  USE  OF  THE  PROGRAM  FALLS
  1126. COMPLETELY ON THE LICENSEE.  LICENSOR SHALL NOT BE LIABLE IN
  1127. ANY  RESPECT FOR ANY CLAIMS, LOSS OR INJURY ALLEGED TO  HAVE
  1128. RESULTED  FROM  USE OF OR IN RELIANCE ON  PROGRAM.  IN  THIS
  1129. RESPECT,  LICENSEE  SHALL COMPLETELY  INDEMNIFY  AND  DEFEND
  1130. AGAINST  ANY  AND  ALL  CLAIMS, INCLUDING  CLAIMS  BY  THIRD
  1131. PARTIES  OR  EMPLOYEES OF LICENSEE, WHICH ARISE DIRECTLY  OR
  1132. INDIRECTLY OUT OF LICENSEE'S USE OR OPERATION OF PROGRAM.
  1133.  
  1134. LICENSOR   SHALL  NOT  BE  LIABLE  FOR  ANY  INCIDENTAL   OR
  1135. CONSEQUENTIAL DAMAGES SUFFERED BY LICENSEE THROUGH  THE  USE
  1136. OF PROGRAM, WHETHER OR NOT SUCH DAMAGES SUFFERED BY LICENSEE
  1137. THROUGH THE USE OF PROGRAM, WHETHER OR NOT SUCH DAMAGES WERE
  1138. DISCLOSED TO, OR REASONABLY FORESEEN.
  1139.  
  1140. This Program, User's Manual and reference materials are sold
  1141. AS   IS,   without  warranty  as  to  their   performance,
  1142. merchantability or fitness for any particular  purpose.  The
  1143. entire  risk  as  to  the results and  performance  of  this
  1144. program is assumed by you.
  1145.  
  1146. However,  to  the  original  purchaser  only,  the  COMPUTER
  1147. CATALYST CORPORATION warrants the magnetic diskette on which
  1148. the program is recorded to be free from defects in materials
  1149. and  faulty  workmanship under normal use for  a  period  of
  1150. ninety  days  from  the  date of purchase.  If  during  this
  1151. ninety-day  period the diskette should become defective,  it
  1152. may  be  returned  to COMPUTER CATALYST CORPORATION   for  a
  1153. replacement  without  charge, provided you  have  previously
  1154. sent in your registration documentation.
  1155.  
  1156. Your  sole and exclusive remedy in the event of a defect  is
  1157. expressly limited to replacement of the diskette as provided
  1158. above.  If failure of a diskette has resulted from  accident
  1159. or  abuse  the  distributor shall have no responsibility  to
  1160. replace  the  diskette  under  the  terms  of  this  limited
  1161. warranty.
  1162.  
  1163. COMPUTER  CATALYST CORPORATION will not be  liable  for  any
  1164. special,  incidental,  consequential,  indirect  or  similar
  1165. damages  due to the loss of data, loss of business  profits,
  1166. business interruption or any other reason , even if COMPUTER
  1167. CATALYST  CORPORATION  or  an  agent  of  COMPUTER  CATALYST
  1168. CORPORATION  has  been advised of the  possibility  of  such
  1169. damages.  IN  NO EVENT SHALL COMPUTER CATALYST CORPORATION'S
  1170. LIABILITY FOR ANY DAMAGES EVER EXCEED THE PRICE PAID FOR THE
  1171. LICENSE TO USE THE SOFTWARE, REGARDLESS OF THE FORM  OF  THE
  1172. CLAIM.
  1173.  
  1174. This Agreement shall be construed and enforced in accordance
  1175. with  the  laws  of  the  State of Arizona.  Any  action  or
  1176. proceeding brought by either party against the other arising
  1177. out of or related to the Agreement shall be brought only  in
  1178. a  State  or Federal Court of competent jurisdiction located
  1179. in  Maricopa County, Arizona. The parties hereby agree to in
  1180. personam jurisdiction of said courts.
  1181.  
  1182. If any provision of this Agreement is found void, invalid or
  1183. unenforceable,  it  will  not affect  the  validity  of  the
  1184. balance  of  this  Agreement, which shall remain  valid  and
  1185. enforceable according to its terms.
  1186.  
  1187. Licensee   acknowledges  that  it  has  read  the  foregoing
  1188. disclaimers  of  warranty and limitation  of  liability  and
  1189. understands that Licensee assumes the entire risk of use  of
  1190. the Program.
  1191.  
  1192. This  Agreement  can only be modified by mutual  consent  of
  1193. both parties.
  1194.  
  1195. Should  you  have  any questions concerning this  Agreement,
  1196. contact COMPUTER CATALYST CORPORATION, Customer Service, P.O.
  1197. Box 14576, Scottsdale, AZ 85267-4576.  (602) 946-9341.
  1198.  
  1199.                         LIMITED WARRANTY
  1200.  
  1201. This  Program,  User's manual, and reference  materials  are
  1202. sold  "As  is,"  without warranty as to  their  performance,
  1203. merchantability, or fitness for any particular purpose.  The
  1204. entire  risk  as  to  the results and  performance  of  this
  1205. program is assumed by you.
  1206.  
  1207. However,  to  the  original purchaser  only,  the  publisher
  1208. warrants  the  magnetic diskette on  which  the  program  is
  1209. recorded  to  be free from defects in materials  and  faulty
  1210. workmanship  under normal use for a period  of  ninety  days
  1211. from the date of purchase.  If during this ninety-day period
  1212. the diskette should become defective, it may be returned  to
  1213. the publisher for a replacement without charge, provided you
  1214. have  previously sent in your limited warranty  registration
  1215. and signed license agreement to the distributor.
  1216.  
  1217. Your  sole and exclusive remedy in the event of a defect  is
  1218. expressly limited to replacement of the diskette as provided
  1219. above.   If failure of a diskette has resulted from accident
  1220. or  abuse  the  distributor shall have no responsibility  to
  1221. replace  the  diskette  under  the  terms  of  this  limited
  1222. warranty.
  1223.  
  1224. Any  implied warranties relating to the diskette,  including
  1225. any implied warranties of merchantability and fitness for  a
  1226. particular  purpose, are limited to a period of ninety  days
  1227. from date of purchase.  Distributor shall not be liable  for
  1228. indirect  special, or consequential damages  resulting  from
  1229. the  use  of  this product.  Some states do  not  allow  the
  1230. exclusion  or  limitation  of  incidental  or  consequential
  1231. damages,  so the above limitations might not apply  to  you.
  1232. This  warranty gives you specific legal rights, and you  may
  1233. also have other rights which vary from state to state.
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.                                                                                                                  Page 27
  1250.                                                                                                                    &F
  1251.  
  1252.  
  1253.  
  1254.